package com.numberone.iotplatform.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.annotation.EnableAsync;
import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;

import java.util.concurrent.Executor;

/**
 * Spring 异步任务执行器配置类。
 *
 * @EnableAsync 注解开启了 Spring 对异步方法 (@Async) 的支持。
 * 当 Spring 容器启动时，它会寻找一个 Executor 类型的 Bean 来作为异步任务的线程池。
 */
@Configuration
@EnableAsync // 【关键】开启异步功能
public class AsyncConfig {

    /**
     * 自定义一个名为 "taskExecutor" 的线程池 Bean。
     * 我们的 @Async("taskExecutor") 注解会指定使用这个线程池来执行任务。
     *
     * @return Executor 实例
     */
    @Bean(name = "taskExecutor")
    public Executor taskExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();

        // 设置核心线程数：线程池中保持的最小线程数，即使它们是空闲的。
        executor.setCorePoolSize(5);

        // 设置最大线程数：线程池允许创建的最大线程数。
        executor.setMaxPoolSize(10);

        // 设置队列容量：当所有核心线程都在忙时，新任务会先被放入这个队列中等待。
        executor.setQueueCapacity(25);

        // 设置线程名称前缀：方便在日志和监控中识别出是哪个线程池的线程。
        executor.setThreadNamePrefix("DeviceScan-Async-");

        // 初始化线程池
        executor.initialize();

        return executor;
    }
}